table of contents
SASL_GETREALM_T(3) | Cyrus SASL | SASL_GETREALM_T(3) |
NAME¶
sasl_getrealm_t - Cyrus SASL documentation
SYNOPSIS¶
#include <sasl/sasl.h> int sasl_getrealm_t(void *context,
int id,
const char **availrealms,
const char **result)
DESCRIPTION¶
- int sasl_getrealm_t(void *context,
- int id,
- const char **availrealms,
- const char **result)
- sasl_getrealm_t() is used when there is an interaction with
SASL_CB_GETREALM as the type.
If a mechanism would use this callback, but it is not present, then the first realm listed is automatically selected. (Note that a mechanism may still force the existence of a getrealm callback by SASL_CB_GETREALM to its required_prompts list).
- context – context from the callback record
- id – callback ID (SASL_CB_GETREALM)
- availrealms – A string list of the available realms. NULL terminated, may be empty.
- result – The chosen realm. (a NUL terminated string)
RETURN VALUE¶
SASL callback functions should return SASL return codes. See sasl.h for a complete list. SASL_OK indicates success.
Other return codes indicate errors and should be handled.
SEE ALSO¶
RFC 4422,:saslman:sasl(3), sasl_callbacks(3)
AUTHOR¶
The Cyrus Team
COPYRIGHT¶
1993-2016, The Cyrus Team
November 8, 2018 | 2.1.27 |